home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 565 / idealist.3_1 / document / manual.txt < prev   
Text File  |  1991-10-31  |  19KB  |  447 lines
  1.  
  2.             ///       ///                       ///
  3.            ///       ///                       ///  ///              //
  4.           ///       ///                       ///                 //////
  5.          ///   ///////   /////    //////     ///  ///   //////    ///
  6.         ///  ///  ///  ///  ///       ///   ///  ///  ///    //  ///
  7.        ///  ///  ///  ////////  /////////  ///  ///    ////     ///
  8.       ///  ///  ///  ///       ///   ///  ///  ///        ///  ///
  9.      ///  ///  ///   /// ///  ///   ///  ///  ///  //   ///   ///
  10.     ///    //////     ////    ///////// ///  ///    /////      ///
  11.                                        ///
  12.   /////////////////////////////////// ////////////// ////////////////
  13.   //    //    //    //    //    //   //////////////  //    //    //
  14. /////////////////////////////////// ////////////// /////////////////
  15.  
  16.                     -----------------------------
  17.                     V  E  R  S  I  O  N     3 . 1
  18.                     -----------------------------
  19.  
  20.                     -------------------------------
  21.                     Written by Christoph Bartholme,
  22.            Ettlinger Str. 37, W-7500 Karlsruhe 1, Germany
  23.       Developed with mit ST Pascal Plus (CCD) and Assembler (Devpac).
  24.       ---------------------------------------------------------------
  25.  
  26.              -----------------------------------------------
  27.              <<<<< A German version is also available! >>>>>
  28.              -----------------------------------------------
  29.  
  30.  
  31.  
  32. Copyright
  33. ---------
  34. IdeaList  is  public domain and may be used and copied by everyone. The only
  35. condition  is  to  copy  the  COMPLETE and  UNCHANGED contents of the folder
  36. IDEALIST.3_1  (the  file CONTENTS.TXT defines it). The author is not respon-
  37. sible for any damage caused by using this program!
  38.  
  39. A small preamble
  40. ----------------
  41. This  manual  is  not very detailed. But all functions of IdeaList are quite
  42. easy  to  understand!  The  most  difficult  matter, if at all, is to modify
  43. printer  adaption files for your special use. My English knowledge is rather
  44. poor.  The  German  manual  is  much more detailed. If you intend to write a
  45. better instruction guide, just let me know!
  46.  
  47.  
  48. Purpose
  49. -------
  50. IdeaList  is  a  versatile  tool to print out text files. It offers a lot of
  51. helpful  functions  to use your printer in a most clever way and to minimize
  52. paper  consumption.  All  kinds of ASCII files and WORDPLUS documents may be
  53. processed.
  54.  
  55.  
  56. Features
  57. --------
  58. The most important printer features are as follows
  59. (keys in '<>'; obvious the mouse ist useable too):
  60. - Four different kinds of font size selectable
  61. - Printing in up to to nine columns
  62. - Too long lines will be made-up correctly.
  63. - Seperated output of front and pages
  64. - Versatile editable head line
  65. - Line numbering option
  66. - Versatile adaption to every printer by an editable ASCII-file
  67. - download fonts for matrix printers and Laserjet compatibles
  68. - Seperate management of continous paper and cut sheets
  69. - Chain mode saves paper by using the rest part after the last text
  70. - Skipping pages and stop at every time
  71.  
  72. The features of comfort are:
  73. - All commands by mouse or keyboard employment
  74. - Page preview with the choosen layout
  75. - Saving and loading of your personal setup
  76. - Changing of the adaption at every time
  77. - 'Show File' like the desktop function
  78. - Direct link to your favorite editor program
  79. - Shell function to call further programs
  80. - Statistics of the actual text file
  81. - Automatic installation of a text file
  82.   by the 'Install Application' feature of the desktop
  83.  
  84.  
  85. Accessory version
  86. -----------------
  87. There  is  also  an  accessory  version of IdeaList, called ILIST.ACC, which
  88. offers  nearly  the  same  amount  of  features  as the PRG version. The ACC
  89. version has no
  90. - keyboard usage
  91. - disk output
  92. - clipboard interface
  93. - calling other programms
  94. - editor link
  95. - line magnification and locating at preview
  96. and does not run in resolutions less than 640 * 400 pixels
  97.  
  98. But there are some features, only the ACC version offers:
  99. - can be called in every GEM application
  100. - printing  happenes  as  a  background task ('spooling') while working with
  101.  another program
  102. - Interface to some other programs (Gemini, CLIPBRD.ACC)
  103.  
  104.  
  105. Conditions
  106. ----------
  107. IdeaList  runs  with every TOS and every resolution mode of the ST/TT with a
  108. minimum of 640 * 200 pixels.
  109.  
  110.  
  111. Starting
  112. --------
  113. IdeaList  needs its RSC-files (IDEALISM.RSC for hi res, IDEALISC.RSC for mid
  114. res, ILIST.RSC for the accessory) in the same directory. At the first time a
  115. adaption  file  named  IDEALIST.IDA should be there too. If IdeaList finds a
  116. file  named  IDEALIST.INF  (accessory:  ILIST.INF),  all  parameters and the
  117. adaption  file  are  set  as  defined  in  this  file. At the first time any
  118. IDEALIST.INF  must  NOT  exist!  This  file  is  created  by  clicking 'save
  119. parameters' or automatically by ending IdeaList.
  120.  
  121.  
  122. User interface
  123. --------------
  124. All functions can be made either by clicking with the mouse cursor or useing
  125. the according key. You may move the boxes of the desktop or the dialog boxes
  126. by  klicking  and  dragging  at the grey buttons. The 'arrowed' buttons also
  127. accept  double  clicks  to set the maximum or minimum value. Instead of this
  128. you  also  may  press a <shift>-key. The <control> key allows working in the
  129. 'professional  mode'.  That  means  a  quicker  execution of some functions,
  130. because the alertboxes appearing else are skipped. Just try it...
  131.  
  132. All  Desktop  boxes  and  the  dialog  boxes  can  be  moved as desired. The
  133. positions are saved by saving the other parameters.
  134.  
  135. Selecting  any  function while pressing the ALT-key causes an alert telling,
  136. that  no  online  help is installed. The online help is an accessory that is
  137. not (yet?) available in English, so you have not got it. Sorry!!
  138.  
  139. Printer management
  140. ------------------
  141. IdeaList  itself will manage the printer's paper position. Especially if the
  142. chain  mode  is  selected,  you  must neither move the paper position at the
  143. printer nor switch it off! A formfeed is caused by pressing <F>. If IdeaList
  144. wants  you  to  init  the paper position, it will show a corresponding alert
  145. box.
  146.  
  147.  
  148. Menu line
  149. ---------
  150.  
  151. - "IdeaList"
  152.   - "Information" : Something about the copyright and the author...
  153.   - "Accessories" : May be used without restrictions while working with
  154.      IdeaList;
  155.  
  156. - "File"
  157.   - "Load...": loads a text file
  158.   - "Show": Shows the text; similar to the corresponding desktop function;
  159.   - "Output to Monitor":
  160.      This  function  gives  you  a  small  preview,  page  by  page. You may
  161.      locate  lines  by  moving the mouse cursor into the page image. Instead
  162.      of  the  menu  line  the  corresponding text line is shown in the upper
  163.      monitor  area. Make-up lines are indicated by '<--'. "Statistics" gives
  164.      a summary of the full text file.
  165.   - "Output to Printer":
  166.      The  main function of IdeaList. Printing can be aborted by pressing any
  167.      key.
  168.   - "Output to File...":
  169.      Instead  to  the printer the output is directed into a file. So you may
  170.      layout  a  text  at home, print it into disk and make a better printout
  171.      with the laser printer at the office...
  172.   - "Load Clipboard": Loads a file called SCRAP.TXT from the GEM-clipboard.
  173.   - "Save Clipboard":
  174.      Saves the text into the GEM-clipboard as it is layouted just now.
  175.   - "Quit": If you do not know, what it is for, don't klick it!
  176.  
  177. - "Options"
  178.   - "Headline":
  179.      Some  options  to  edit  the headline; The headline is divided in three
  180.      parts:  left  side,  middle and right side. IdeaList offers some macros
  181.      introduced  by  a  '#'.  "Number Offset" is added to the temporary page
  182.      number.  "Blank  Lines"  are  lines  between  the headline and the text
  183.      begin.
  184.   - "System...": Some general adjustments
  185.      - "File output with char. adadptions and printer control codes":
  186.        If  selected  the file output is absolutely the same as the output to
  187.        the  printer.  Otherwise there is only a pure text output without any
  188.        control codes.
  189.      - "Grow/shrinkboxes": Enables this well known graphic effect...
  190.      - "Cut lines at word ends" :
  191.        if  a line is too long to be printed undivided, IdeaList cuts it into
  192.        two  pieces. If this option is selected, the division appears between
  193.        complete words.
  194.      - "Tab size":
  195.         The ASCII-code 09 gets expanded to the selected distance.
  196.      - "Save parameters before quit":
  197.        If  selected,  IdeaList  saves  all the temporary parameters and file
  198.        paths into IDEALIST.INF, when you quit the program.
  199.   - "Load Adaption...":
  200.      Installes a new printer adaption file.
  201.   - "Load Parameters...":
  202.      Installs  all  parameters  and  file  paths from a INF-file. Even a new
  203.      printer adaption file gets installed if defined so in the INF-file.
  204.   - "Save Parameters"...:
  205.      Saves all parameters and file paths into a INF-file.
  206.  
  207. - Extras
  208.   - "Formfeed":
  209.      Sends  a  formfeed  code  to  the  printer;  this command may break the
  210.      "chain" mode.
  211.   - "Find Editor...":
  212.      Allows to define a new editor's name and path.
  213.   - "Call Editor..":
  214.      Starts  the  embedded editor; the command line to be handed over can be
  215.      defined  in  three  ways:  the  text  file,  the  adaption file or free
  216.      editable. After all this file may be reinstalled.
  217.   - "Call Program...":
  218.      Starts any desired program and returns back to IdeaList after that.
  219.      The command line options comply with the editor's ones.
  220.   - "Call IdeaForm":
  221.      Starts a IdeaForm after handed over the text file's name by the command
  222.      line;  IdeaForm  is a utility to format any source code files. Keywords
  223.      and  commends  get  control  codes  to be emphasized. For that IdeaForm
  224.      creates  a  file  with the extender 'TXA' (TeXt with Attributes). After
  225.      that  IdeaList  installs  this file instead the old one, and so you may
  226.      print  out  your  source  file  in  a  pretty look. IdeaForm requires a
  227.      special  key file including the adaptions to the respective programming
  228.      language.
  229.  
  230. Desktop buttons
  231. ---------------
  232. - Font size 1 - 4:
  233.    These  buttons  select  one  of the font sizes as defined in the adaption
  234.    file.
  235. - Columns:
  236.    The text can be set in up to nine columns.
  237. - "Chain" mode: after having printed a text the printer does not put out the
  238.    sheet,  but  the  rest  length  is saved for printing the next text. This
  239.    feature may save al lot of paper at printing several short files.
  240. - "1 3 5.." and "2 4 6..":
  241.    Only  the  front pages (odd numbers) or the rear pages (even numbers) get
  242.    printed: This allowes printing on both sides of every sheet even by using
  243.    a automatic cut sheet feeder or contionous paper.
  244. - "Normal": Neither "Chain" mode nor the front/rear page mode is selected.
  245. - "0 with slash":
  246.    To  distinguish  between  the number '0' and the character 'O' the output
  247.    appears with a slashed zero as on monitor.
  248. - "Numbers":
  249.    Every  line  gets  introduced  by  a  running number. So cut lines can be
  250.    recognized.
  251. - Headline: enables a headline at the begin of every page.
  252. - High Quality: Toggles between draft mode and letter quality.
  253. - Skip pages:
  254.    If  selected  there  is  a alertbox before every page that allows to skip
  255.    this  page. Thus even only one single page of a big document may be prin-
  256.    ted.
  257. - Joker:
  258.    This button is reserved for your own special use. For that you may define
  259.    any font attribute in the adaption file.
  260. - Margin: defines the left margin (at rear pages: the right margin)
  261. - "Single": Use of single cut sheets
  262. - "Contionous" : Use of 'endless' contionous paper
  263.  
  264. The  Buttons "Disk->", "->Monitor", "->Printer" and "->Disk" comply with the
  265. menu functions. The "Text" and "Adaption" areas may be clicked too.
  266.  
  267.  
  268. Download fonts
  269. --------------
  270. You  may  use  any  download  font  (matrix printers) or Soft Font (LaserJet
  271. compatibles)  instead  of the inbuild fonts. The font(s) must be declared in
  272. the  adaption  file.  Be  shure,  that  your printer accepts download fonts.
  273. Perhaps  there  is a special DIP switch or a RAM expansion card is required.
  274. Most matrix printers only accept 7-bit fonts with the ASCII range from 32 to
  275. 127.  Fonts  marked by the extenders 'P09' or 'P24' (like the enclosed ones)
  276. are not in full ASCII order (you know: the German 'Umlaute'...), so IdeaList
  277. adapts them internally. Also ordinary 7-bit fonts in full ASCII order may be
  278. used  if  they  got a different extender. If desired a character adaption of
  279. them  can be made by the table in the adaption file. LaserJet soft fonts may
  280. be applied as usual.
  281.  
  282.  
  283. Wordplus files
  284. --------------
  285. IdeaList prints wordplus files as well as simple ASCII files!
  286. Any text attribute (bold, light, italic, underlined, subscript, superscript)
  287. will  be  printed.  The  only  restrict  is:  IdeaList  ignores pictures and
  288. headlines.  The  reason is, that IdeaList has much less paper consumption of
  289. Wordplus.  So  the  original page division is not identical to the partition
  290. made by IdeaList.
  291.  
  292.  
  293. Printer adaption file
  294. ---------------------
  295. The  printer  adaption  file IDEALIST.IDA will be installed by default, when
  296. IdeaList  is  started and there is no IDEALIST.INF. For your special purpose
  297. or if your printer does not unterstand the default codes, it can be modified
  298. by  any  (ASCII-) text editor. The comments will help you. The (German) test
  299. files  in  the folder TESTTEXT may be useful. A look into the other adaption
  300. files in the folder DRUCKER is advisable in every case.
  301.  
  302. The adaption file contends the parameters as follows in the same order.
  303. Commends  are  initialised  by  a  '*';  hexadecimal numbers are marked by a
  304. leading '$'; Strings andsingle characters must be set in '...';
  305.  
  306. - NAME OF ADAPTION (up to 24 chars)
  307.  
  308. - NAMES OF THE FONT SIZES (up to 12 chars)
  309.  
  310. - NAME OF THE JOKER (up to 12 chars)
  311.  
  312. - FONTS (0 = internal)
  313.  For  every  of  the  four font sizes you must define either a '0' (internal
  314.  font)  or  the  name of the corresponding download font file (if not in the
  315.  same directory, the full path must be declared here).
  316.  
  317. Size Parameters:
  318.  
  319. - NET PAGE LENGTH IN INCH (for contionous paper)
  320.  
  321. - TEXT DISTANCE IN INCH (for chain mode)
  322.  
  323. - MINIMUM REST LENGTH IN INCH (chain mode)
  324.  
  325. - NUMBER OF LINES IN PICA-LINES (6 lpi) (single paper):
  326.  Mostly  this  value   cannot  be  found  in  the printer manual, but can be
  327.  determined  easiely.  You   just  must  print  out  a  simple text with the
  328.  corresponding  desktop  function.  The line distance has to be 6 lpi (lines
  329.  per  inch).  Now  you get the value by counting the lines of one page. Most
  330.  printers print 60 pica-lines per page or more.
  331.  
  332. - LINES/INCH SIZE 1 - 4
  333.  
  334. - MAXIMUM LINE LENGTH IN PICA-CHARS (10 cpi)
  335.  For a 8-inch-printer you must choose '80'.
  336.  
  337. - CHARS/INCH SIZE 1 - 4
  338.  
  339. - COLUMN DISTANCE IN CHARS
  340.  Normally this value is '1' to make best use of the paper width
  341.  
  342. - RIGHT MARGIN IN CHARS
  343.  Normally this value is '0' to make best use of the paper width
  344.  
  345. - STEPS/INCH FOR HORIZONTAL SPACING (0 = not used)
  346.  This  valus  must  be  a '0', if you use the standard spacing mode (writing
  347.  blank  chars).  If you intend to use proportional spaced fonts you must set
  348.  the step size here (24-pin: '60', LaserJet : '300')
  349.  
  350. - MODE OF SENDING (0=normal)
  351.  The  value  for  for standard use is '0'. Then IdeaList sends download font
  352.  data only if needed.
  353.  The other modes are:
  354.  - Mode 1:
  355.   Download  data will be send EVERY time before printout (of course only, if
  356.   not a internal font is selected!)
  357.  - Mode 2:
  358.   All  codes  for  the  printer  setup  will be send before EVERY PAGE. This
  359.   mode ignores the 'Chain' option!
  360.  - Mode 3:
  361.   A combination of mode 1 and mode 2...
  362.  
  363. - CONFIGURATION OF PORT/CUT SHEET FEEDER:
  364.  This flags define the used printer hardware:
  365.  
  366.   Value |   Port   | cut sheed feeder
  367.   ------+----------+-----------------
  368.     0   | parallel | manual
  369.     1   | parallel | automatic
  370.     2   | serial   | manual
  371.     3   | serial   | automatic
  372.  
  373.  If your printer does not work at all, the port definition may be wrong!
  374.  
  375. Printer Control Codes (maximum : 20 chars):
  376.  
  377. - INITIALISE
  378.  
  379. - CODES AT THE END
  380.  
  381. - SKIP-OVER PERFORATION OFF
  382.  
  383. - DEFINE GROSS PAGE LENGTH
  384.  
  385. - DEFINE CHARACTER WIDE/HIGHT size 1 - 4:
  386.  Condensed  and subscript must be switched off here, if not used. If you use
  387.  a   download  font,  the  corresponding  quality  (draft,  LQ  proportional
  388.  spacing...)  must be set here.
  389.  
  390. - DEFINE LINE SPACING size 1 - 4
  391.  
  392. - DRAFT AND LETTER QUALITY:
  393.  For download fonts this codes will not be send.
  394.  
  395. - JOKER ON and JOKER OFF:
  396.  This  codes  are reserved for your own special use! What about switching to
  397.  italic  or  another  kind  of  font. Line spacing and font size must not be
  398.  changed by this codes!
  399.  
  400. - HEADLINE INIT and HEADLINE EXIT:
  401.  Some effects to emphasize the headline (bold underlined...) may be set here
  402.  and  must  be switched off in the corresponding line. Line spacing and font
  403.  size must not be  changed by this codes!
  404.  
  405. - BOLD ON/OFF, LIGHT ON/OFF, ITALIC ON/OFF, UNDERLINE ON/OFF,
  406.   SUPERSCRIPT ON/OFF, SUBSCRIPT ON/OFF:
  407.  the well known printing attributes...
  408.  
  409. - INIT DOWNLOAD DATA and EXIT DOWNLOAD DATA:
  410.  Between this codes IdeaList sends the data of the download font
  411.  
  412. - DOWNLOAD FONT ON and DOWNLOAD FONT OFF:
  413.  Selects or deselects downloadfont mode.
  414.  
  415. - HORIZONTAL SPACING:
  416.  If  you  If  you  intend  to use proportional spaced fonts you must set the
  417.  codes  for stepping here. The real size value will be set in by IdeaList if
  418.  you mark its place by a '255'
  419.  
  420. - ZERO WITH SLASH:
  421.  To distinguish between the number '0' and the character 'O', IdeaList sends
  422.  this code, if the corresponding option is set.
  423.  
  424. Character Adaptions
  425. the  first  number  defines  the atari character. Then a line up to 20 codes
  426. follows. If a character cannot be printed at all, set it to '32' (blank).
  427.  
  428.  
  429. Internals
  430. ---------
  431. IdeaList  can  be adapted to any language (not only English and German..) by
  432. just  modifieing  the  RSC-files.  All  messages,  alerts  and  dialogs  are
  433. contained  in  them.  If you intend to adapt IdeaList to your mother tongue,
  434. just let me know!
  435.  
  436.  
  437. Notes
  438. -----
  439. If  you  get  any  problems, questions or ideas, just send me a note. As you
  440. know,  IdeaList supports the public domain idea. If you think IdeaList to be
  441. useful  for  your work , you ought to send me a adequate contribution. Since
  442. today  there  were  really  a lot of hours of programming and bug hunting...
  443. Obvious  you  will  get the latest version of IdeaList and some more helpful
  444. tools. Thanx!
  445.  
  446. ----------------------------------------------------------------------------
  447.